home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / c / moush101.zip / README.TXT < prev    next >
Text File  |  1992-07-27  |  4KB  |  81 lines
  1. README.TXT for mouse routines
  2.  
  3. Michael Chen    mchen@groucho.cs.psu.edu
  4. 7/26/1992
  5.  
  6. INTRODUCTION
  7.  
  8.    Hello out there!  If you have downloaded this file, either you are curious
  9. to see routines that use a mouse, or you are in the same predicament I was in
  10. less than a week ago.
  11.    I wanted to find some way use the mouse from within my Turbo C++ programs.
  12. But there are no built-in routines, so I began scavenging the Internet ftp
  13. sites for something suitable.
  14.    I ended up with two candidates, MOUCLIB and MMOUSE.  Neither really seemed
  15. to fill the bill.  MOUCLIB needed TASM to build itself, which I don't have; 
  16. MMOUSE worked, but seemed a little inelegant and sluggish.  I sighed and dug
  17. around some more for documentation on the interrupt calls.
  18.    Lo and behold, I found INTER31, the interrupt list to end all interrupt
  19. lists!  Kudos to Ralf Brown for this gem.  (Of course, I'm strapped for disk
  20. space, so I left it on my Sun account and grep'd for the mouse calls.)
  21.  
  22. SUMMARY (brief)
  23.  
  24.    A day later, MOUSE was born!  It's fast, and it uses the interrupt calls
  25. from Ralf Brown's list.  (A copy has been included in the file MOUSE.TXT.)
  26. In its current state, it merely provides a nice way to use the mouse.  I have
  27. not made a .DOC file, because in its current state the MOUSE.TXT file is
  28. documentation enough.  I haven't bothered to include the source for the same
  29. reason --- it's boring, and the only nifty thing is the .HPP include file for
  30. C++, which I'm including.
  31.    In future uploads, I hope to get an event handler going, and provide the
  32. usual extra mouse cursors, etc.  I have not included an interface for Turbo
  33. Pascal, basically because the last version I used was 3.0, and I have no idea
  34. what TP is like these days.  If anyone makes one, please send me a copy so I
  35. can include it in the next post.
  36.    If anyone has wishes, suggestions, etc., please e-mail or write me, and
  37. tell me what you're using it for. (Address below)
  38.  
  39. RIGHTS & WHATNOT
  40.  
  41.    I'm no lawyer, so this is going to be really informal.
  42.    Being a relatively poor college student, I hate not being able to use a
  43. program just because I can't afford it.  So, following the Golden Rule, you
  44. don't actually HAVE to pay anything to use this.  I'd rather not stifle any
  45. poor soul's creative energies for a lousy buck.
  46.    The above assumes that you, in turn, will not charge fees to use programs
  47. incorporating this code.  If you do want to charge people, please "register"
  48. by telling me who you are, what you're making, and including $25 US.  (I'm
  49. assuming that anyone who is actually going to make money isn't going to miss
  50. such a paltry sum.)
  51.    If you include this code in a program to be released to others, please
  52. mention my name somewhere, and contact me, so I can find out if people will
  53. really use this.
  54.    Donations are always welcome if you can afford them, of course... :)
  55.  
  56. DISCLAIMER
  57.  
  58.    I take no responsibility for any damage, incidental or otherwise, which
  59. results from the use of this code.  (It's just a bunch of interrupt calls to
  60. the mouse driver!) :)
  61.    This software has been tested on my 386SX/25 with 2 megs of RAM, a Trident
  62. SVGA card w/512K, and a 40MB IDE hard drive.  (Pretty hurting for development
  63. systems, I know.)  It hasn't caused any problems, and I don't expect any.
  64. From personal experience, mouse bugs are usually the driver's fault, so just
  65. try upgrading your mouse driver first.
  66.  
  67. ADDRESSES (until August 14, 1992)
  68.  
  69.     461 East Beaver Avenue
  70.     State College, PA 16801-5633 USA
  71.  
  72.     mchen@groucho.cs.psu.edu    (primary)
  73.     mchen@cs.psu.edu        (if for some reason the above
  74.                      address is unreachable)
  75.  
  76. Enjoy!
  77.  
  78. --- Michael Chen
  79.     7/26/1992
  80.  
  81.